launch url

Type

command

Summary

Launches a url in the appropriate manner for the current system.

Syntax

launch url <urlToLaunch>

Description

Use the launch url command to open a url using the default action for the current system. The command performs an action appropriate to the protocol and address provided in the given URL.

The following URL schemes are supported:

• http: and https: URLs, which launch in the default browser application if available
• file: URLs, which open the file in the associated application
• tel: URLs, which open the dialer with a given phone number

note

The urlToLaunch must be a standards-compliant URL. In particular, file: URLs must be of the form file://absolute path, and the path should be URL-encoded.

Important

Mobile: Successfully launching a url will cause another application to open and the requesting application to be quit. The application will receive a shutdown message before this happens.

Android

files in specialFolderPath("engine") and specialFolderPath("resources") cannot be accessed via launch url.

Parameters

Name	Type	Description
urlToLaunch		The URL to launch.

Examples

launch url "http://www.livecode.com"

launch url "file:/Users/ben/Desktop/test.pdf"

launch url "tel:44 7818 8822"

Related

glossary: URL, URL scheme

keyword: URL

command: revGoURL, launch, launch document

function: URLEncode

Compatibility and Support

Introduced

LiveCode 2.9

OS

mac

windows

linux

ios

android

Platforms

desktop

mobile